fix(docs): section-URL 404s + Python capabilities page#391
Conversation
Sections with child pages but no landing page (each SDK's getting-started, and resources) 404'd on a bare hit — e.g. clicking the "Getting Started" breadcrumb crumb. Redirect them to the section's first page.
Python's getting-started was missing the capabilities overview the other SDKs have. Maps each feature to its Python guide.
|
Warning Review limit reachedYou’ve reached a temporary PR review limit under our Fair Usage Limits Policy. Next review available in: 3 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: defaults Review profile: CHILL Plan: Pro Run ID: 📒 Files selected for processing (3)
✨ Finishing Touches🧪 Generate unit tests (beta)
Comment |
1 participant
Fix docs "Page not found" on section URLs + add Python capabilities page
Two docs fixes.
1. Index-less section URLs 404
Sections that have child pages but no landing/index page — each SDK's
getting-started, andresources— 404'd on a bare hit. This is reachable from the breadcrumb: on any…/getting-started/quickstartpage the "Getting Started" crumb links to the bare/<sdk>/getting-started, which had no page → "No documentation page matches this URL." (affects every SDK).Fix: redirect these bare section URLs to the section's first page via the existing static-redirect mechanism (prerendered stub + SPA client-nav):
/{node,python,java}/getting-started→…/getting-started/installation/resources→/resources/comparison2. Python getting-started missing "Capabilities at a glance"
The Node and Java SDKs have a
capabilitiespage in getting-started; Python didn't. Addedpython/getting-started/capabilities.mdx(a feature → guide map, mapped to Python's actual guide URLs) and listed it in the section'smeta.json.Verification
biome check+typecheckclean; full docs build succeeds — the four redirect stubs prerender with the correctmeta-refreshtargets, andpython/getting-started/capabilitiesprerenders.